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Preface 


This manual provides information needed to plan for the installation and 
use of the OS/VS2 MVS Interactive Problem Control System (IPCS), a 
selectable unit that allows the user to analyze and manage system 
software problems in an OS/VS2 MVS TSO environment. 


This manual, which provides a general description of IPCS as well as 
planning information, is divided into the following sections: 


1. Introduction -- a general understanding of IPCS structure and 
function. 


2. Planning -- the IPCS requirements on the hardware and programming 
environments of the installation. 


3. Supplemental Information -- publications support and program module 
information related to IPCS. 


This publication is intended to provide planning information for 
installation managers, system programmers, and IBM Field Engineering 
personnel. It is assumed that the readers have a basic knowledge of 
OS/VS2 MVS and TSO. 


For general information on installing selectable units, refer to 
Selectable Unit Installation Guide, GC28-0747. 


For specific installation information, refer to the program directory 
for the OS/VS2 MVS IPCS selectable unit, shipped with the program fron 
the Program Information Department. 


Detailed information for the IPCS user, including selected installation 
considerations, is provided in the OS/VS2 MVS Interactive Problem 
Control System (IPCS) User's Guide and Reference, GC34-2006. 
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Section 1. Introduction 


The OS/VS2 MVS Interactive Problem Control Systen (IPCS) provides MVS 
installations with expanded capabilities for diagnos sing software 
failures and facilities for managing problem information and status. 
This section provides an overview of the IPCS functions provided to a 
user, an overview of its use, and the data utilized and maintained by 
IPCS. 


Operating Environment 


IPCS operates as a TSO command processor under OS/VS2 MVS. All IPCS 
Ssubcommands are treated aS Subcommands of the IPCS command. 


Functional Characteristics 


IPCS includes facilities for: 
e Online examination of storage dumps. 
e Analysis of key MVS system components and control blocks. 


e Online management of a directory of software problems that have 
occurred in the user's systen. 


e Online management of a directory of problem-related data, such as 
dumps or the output of service aids. 


TPCS runs under TSO, allowing the user to access existing TSO facilities 
during an IPCS session, and giving the user the ability to create and 
execute command procedures (CLISTs) containing the IPCS command and its 
subcommands. 


Dump Data Examination and Analysis 


IPCS provides functions for displaying and analyzing information present 
in an OS/VS2 MVS storage dump. 


The functions operate in line-oriented mode or full-screen mode. 
Line-oriented mode allows the user to enter subcommands, TSO commands, 
or TSO CLISTs, and to display areas of storage or summary sd a of MVS 
components or control blocks. 


For IBM display stations supported by TSO (3275 Model 2, 3277 Model 2, 
3276 Models 2 and 12, and the 3278 Model 2 attached via the 3276 or 
3274), full-screen option is available for examining dump data. The 
option provides functions to utilize these display terminais in 
preformatted full-screen mode. Data entry, cursor placement, or program 
function keys (where available) may be used for basic operations, such 
as scrolling or splitting the screen to display multiple areas or 
multiple formats within a dump. 
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Dumps Supported 

Dumps must reside on DASD prior to the use of the dump data examination 

and analysis functions. IPCS supports three forms of MVS storage dumps: 

e High-speed stand-alone dumps produced by AMDSADMP. 

e Virtual dumps produced by MVS SDUMP on SYS1.DUMPnn data sets. 

® Virtual dumps produced by MVS SDUMP on data sets specified by the 
SYSMDUMP DD statement, when the Dumping Improvements Selectable Unit 
(SU33) is installed. 


Dumps on data sets specified by the SYSABEND or SYSUDUMP DD statements 
cannot be analyzed using IPCS facilities. 


When a stand-alone dump, created by AMDSADMP, is being processed, IPCS 
Supports access to: 


° The storage and storage keys. 


e The dump title, the CAW, the CSW, and other data placed in the 
header record. 


e The data placed in the CPU status record. 
Access to the storage is available by: 


e Virtual addresses, using both DAT hardware simulation and emulation 
of MVS page reclamation. 


° Real addresses, Simulating prefixing on multiprocessor systems. 
e Absolute addresses. 


When a virtual dump, created by MVS SDUMP, is being processed, IPCS 
Supports access to: 


a The virtual storage and storage keys. 


e The dump title, current PSW, and registers written in the header 
record. 


e The dump Summary records, when the Dumping Improvements Selectable 
Unit (SU33) is installed. 


Dump Formatting 


The dump examination function allows the user to tailor the formatting 
of storage by providing: 
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e Hexadecimal displays. 


e Character displays. 

@ Traditional dump formats of combined hexadecimal and character 
displays. 

® Decimal displays. 

6 Compression of repetitive data from storage. 


e Optional display of storage keys. 


Dump Data Isolation 


IPCS allows the user to refer to and locate link pack area modules and 
key MVS control blocks by name. To avoid unnecessary system overhead, 
the look-up process for each control block is deferred until it is 
explicitly requested by the user, or until it is implicitly requested by 
the use of a subcommand which must find and use the data. 


Dump Data Validation 


Key MVS control blocks in dumps accessed by IPCS are checked for 
validity prior to their use. One validation process is used for each 
control block, regardless of the number of IPCS subcommands accessing 
Vt. 


Dump Analysis Routines 


IPCS provides high-level summaries of the status of several key MVS 
system components: 


e The ASCBs, ASXBs, TCBs, and RBS are located, formatted, and 
Summarized. Selective display of the ASCB, ASXB, TCBs, and RBs for 
one address space at a time is supported. 


e The status of the auxiliary storage management component is 
summarized, highlighting critical statistics, the locations of key 
data areas, and the addresses of the paging data sets. : 


e The status of the communication task component is summarized, 
highlighting outstanding WTOR messages, and those consoles to which 
messages have been queued but not yet transmitted. 


e ENQ/DEQ resource management chains are summarized. The selective 
display of the chains associated with a major resource name is 
Supported. 


e The status of the I/0 supervisor component is summarized, 
highlighting critical statistics and the locations of key data 
areas. 
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Problem Management 


Functions are provided for managing problem information and status at an 
MVS installation and keeping that information centralized and available 
to all personnel involved in the resolution of problems. 

Problem management includes functions for: 


e Adding problems to, and deleting problems from, the IPCS problem 


directory. 
® Maintaining problem status information. 
° Displaying and printing existing problem information. 
Data Management 


Functions are provided for maintaining a list of the data sets 
associated with a problem. The purpose of this list is to allow the 
IPCS user to rapidly find the data associated with a problem. 

Data management includes functions for: 


e Associating a data set with, or disassociating a data set from, a 


problen. 
e Maintaining type and description information about a data set. 
® Displaying and printing information about existing data sets. 
IPCS Use 


To fully understand the problem management and prebren~ sot yang 
capabilities that IPCS offers, it is helpful to: 


e Walk through a typical IPCS session. 
e Know the functions offered by the IPCS commands and subcommands. 


e Visualize the full-screen displays of IPCS. 


Session Scenario 


When problems are discovered, the user now has IPCS to control them. He 
Can create an entry for the problem in the problem directory and provide 
descriptive information. He can associate data sets (dumps, service aid 
output, etc.) with that problem in the data set directory. 


Once the problem and its associated data have been identified, the user 
can proceed to display dumps and other problem-related data needed to 
solve the problem. IPCS provides extensive dump analysis and 
examination facilities to aid in the debugging process. The DSPL3270 
subcommand provides dump display in a full-screen environment. 


At any point in the process, new information can be added to the problem 
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directory which keeps the status of the problem current. 


The user can 


gather information about this problem, together with data about other 


problems, 


to prepare comprehensive reports of all problems within an 


installation or problems of a particular category. 


When the problem has been resolved, the uSer can write the results in 


the problem directory. 


Can remove the names of dumps or other associated data sets. 


Commands and Subcommands 


The following list shows the TSO commands and the subcommands of IPCS 


with a general statement of the functions provided. 


listed first, followed by the subcommands. 


TSO Commands 


IPCS -- Start an IPCS session. 


SYSDSCAN -- Allocate SYS1.DUMP 
data sets and display the 
titles of the dumps in then. 


Subcommands of the IPCS Command 


ADDDSN -- Add a data set name 
to a problen. 

ADDPROB -- Add a problen. 
ASCBEXIT -- Pass control to an 


exit routine that is 
compatible with the AMDPRDMP 
ASCB exit. 


ASMCHECK -- Analyze the 
auxiliary storage manager 
(ASM) . 


COMCHECK -- Analyze the 
communication task component. 
COMPARE -- Perform logical 
data comparison. 

DELDSN -- Delete a data set 
name from a problen. 

DELPROB -- Delete a problem. 
DROPDUMP -- Delete all records 


that describe a particular 
dump from the dump directory 
(a data set that contains 
information about fields 
within a dump). 


The commands are 


IPCSDDIR -- Prepare a dump 
directory data set for dump 
analysis. 


DROPMAP -- Delete records of 
control blocks that have been 
located ina dump. 


DROPSYM -- Delete symbols fron 
the table of symbols that have 
been defined by the user or by 
IPCS during dump analysis. 


DSPL3270 -- Display selected 
portions of a dump with 
full-screen operation. 


END -- Terminate an IPCS 
session. 

ENQCHECK -- Summarize ENOQO/DEQ 
resource management chains. 
EQUATE -- Create a symbol. 
EVALUATE -- Obtain dump data 
for CLIST processing. 

FIND -- Locate data in a dump. 
FINDMOD -- Search for a module 
by name. 
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Then by updating the problem data directory, he 
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FINDUCB -- Search for a UCB. 


HELP -- Provide descriptive 
information about the IPCS 
command and its subcommands. 


IOSCHECK -- Analyze the I/0 
Supervisor component. 


LIST -- Display storage. 


LISTDSN -- List data set 
attributes. 


LISTDUMP -- List dumps 
represented in the dump 
directory. 


LISTMAP -- List control blocks 
that have been located ina 
dump. | 


LISTPROB -- List reported 
problems. 

LISTSYM -- List attributes of 
symbols in the symbol table. 
MODDSN -- Modify data set 
attributes. 

MODPROB -- Modify problem 
attributes. 
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NOTE -- Produce messages and 
control pagination. 


RUNCHAIN -- Search through a 
chain of control blocks. 


SCAN -- Validate key MVS 
control blocks. 


SETDEF -- Set, change, and 
display IPCS session defaults. 


SUMMARY -- Summarize selected 
control block fields. 


TCBEXIT -- Pass control to an 
exit routine that is 
compatible with the AMDPRDMP 
TCB exit. 


TSO -- Invoke a non-IPCS TSO 
command or subcommand 
function. 


VERBEXIT -- Pass control to an 
exit routine that is 
compatible with the AMDPRDMP 
user control statement exit. 


DSPL3270 Screen Format 


The DSPL3270 subcommand initializes the 3270 screen into a 24-line 


display. 


and the bottom 19 lines for the display of data. 


the screen is shown below: 


ZEND 


SK Q0E090 


RF CVT 


ADDR 000008 ASID 
SUBCMND/CLIST: 


000000 
000020 
000040 
000060 
000080 
OO000A0 
0000C0 
OOO0EO 
000100 
000120 
000140 
000160 
000180 
0001A0 
0001C0 
QOO1E0 
000200 
000220 
000240 


070C2000 
0006BE78 
040C0000 
00000000 
00000000 
00000000 
8B26520F 
03000148 
00000000 
FFEFFFFF 
00000000 
0OFFE398 
0001306E 
CO80EC40 
00000000 
D7E2C140 
OOFED098 
040C1000 


7<-SCROLL+>8 9STACK 


10<-SKIP+>11 


The top five lines are used for specific control operations, 


The basic format of 


0014 FMT X AREA A LINES/AREA: A 19 B 00 C 00 


OOD4AOCE 
0c000001 
000308AA 
00001004 
00000000 
00000000 
19744000 
00000000 
00000000 
FFFFFFFF 
00000000 
0OFFE1FO 
0001406C 
OF 1D7C00 
00000000 
00000040 
0OFED098 
0OD4A832 


00000000 
070C0000 
000088A0 
O00C0000 
00020001 
20000000 
00000000 
00000000 
00000000 
00000000 
01010523 
00000000 
OOFF66 34 
00007F80 
FCO00000 
00000000 
OOFFE1FO 
00000000 
00000000 


00000000 
QOD4A000 
0000E090 
000367C4 
0OD4A000 
001FE298 
00000000 
00000000 
00410080 
00000000 
447EE000 
00000000 
OOFFDE28 
OOFF9828 
00000000 
00000000 
OO1FE1FO 
00B74340 
00000000 


0000E090 
040C1000 
B4F35AFF 
00080000 
00000000 
FFFFFFFF 
00000000 
00000000 
00000000 
FFFFFFFF 
25529999 
00000000 
800123B0 
00008110 
00000000 
00000000 
OOFFDE28 
00000000 
070C0000 


00000000 
O001259A 
00000000 
OOOOAF 18 
00000000 
00000000 
00000000 
00000000 
00000000 
0000002A 
42483849 
00000000 
00012070 
OOFFB3E8 
00000000 
00000000 
OO1FDE28 
00000000 
OOD4EA76 


D 00 SKIP 000200 


070C1000 
070E0000 
040C0000 
040C0000 
00000000 
000001D3 
7FFFFFEE 
00000000 
00000000 
FFFFFFFF 
00000000 
00000000 
00000508 
00005080 
00000000 
0FC00000 
00A258F8 
00000000 
040C0000 


0OD4A832 
00000000 
0004555E 
00045766 
00000000 
00000000 
4523CFF8 
00000000 
00000000 
FFFFFFFF 
00000000 
00000000 
000051B0 
00000000 
00000000 
001E6560 
00A258F8 
00B74E40 
0001A8EC 


Line 1 contains a message area and four basic operations that are 
available to the user, either by cursor selection or by program function 
key selection: 


END -- Ends the DSPL3270 function and leaves full-screen mode. 
SCROLL -- Shifts the area of the dump being viewed. 

STACK -- Adds the address being displayed to the address stack. 
SKIP -- Moves the pointer of the display forward or backward. 


Note that each function hasS one or more numbers shown with it. 
numbers indicate which program function key, if available on that 
terminal, can be used to perform the operation. 


Lines 2 and 3 provide for a "stack" mechanisn. 
user to keep addresses for more parts of the dump than can be displayed 


concurrently and to remember what the addresses point to. 
contains a list of addresses, 


and line 3 (RF) 


reference or note about the first address in the list. 


Line 4 contains various fields that define the current display 
The effect of 
changing these fields is reflected on the next screen update. 


environment. 


These fields can be altered by the user. 
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These 


The stack allows the 


Line 2 (SK) 
provides space for a 


Tntroduction 
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Line 5 is used to enter IPCS subcommands or TSO commands or CLISTs. 
When data is entered on this line and the ENTER key is pressed, DSPL3270 
terminates full-screen operation and passes the input to IPCS for 
processing. When the specified operation is complete, the display is 
automatically returned to full-screen mode. 


Lines 6-24 are used to display data from the dump. On line 4, the user 
can allocate these display lines among four display areas: A, B, C, and 
D. The AREA field on line 4 indicates which area is to contain the next 
display. 
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Section 2. Planning for IPCS 


This section identifies the effect of the OS/VS2 MVS Interactive Problem 
Control System (IPCS) Selectable Unit on: 


e Machine requirements. 
e Programming requirements. 
© Storage estimates. 


Machine Requirements 

IPCS operates on any configuration and processor that meets the Minimum 

specifications of OS/VS2 MVS with TSO. 

Use of the DSPL3270 subcommand requires an IBM 3275 Model 2, 3277 Model 

2, 3276 Model 2 or 12, or 3278 Model 2 display terminal attached via the 


3276 or 3274. If the optional program function key feature is 
available, the usability of the DSPL3270 subcommand is enhanced. 


Programming Requirements 


IPCS is designed for use with the OS/VS2 MVS operating system. It 
executes ina TSO environment and supports multiple concurrent users 
sharing a common data base. 


IPCS requires an OS/VS2 MVS Release 3.7 operating system with TSO. 


Dependencies 

The following selectable units are prerequisite to the installation of 
IPCS: 

® Supervisor Performance #1 (SU5). 

e Supervisor Performance #2 (SU7). 

The Dumping Improvements Selectable Unit (SU33), though not prerequisite 
to the installation of IPCS, will enhance its effectiveness. SU33 
captures machine-readable dumps on failures and provides more accurate 


trace table information by preserving the supervisor trace table earlier 
in recovery processing. 


Programming Considerations 


Before installing IPCS for use with TCAM, a new message control program 
(MCP) generation may need to be done. The macros for this MCP 
generation are supplied with IPCS. If the OS/VS2 MVS TSO 3270 Extended 
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Display Support -- Session Manager Program Product, Program Number 
5740-XE2, or TSO-3270 Structured Programming Facility Program Product, 
Program Number 5740-XT8, is installed, the new MCP generation is not 
required. | 


Data Sets 


The following data setsS or members are unique to IPCS: 
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IPCSPRxx Member of SYS1.PARMLIB 


This member contains the parameters needed to tailor the operating 
characteristics of the IPCS system to those desired by the user, and 
contains the cluster names of the data set directory and the problen 
directory. More than one member can be defined, to allow for 
different default requirements within an installation. 


Data Set Directory 


This VSAM data set contains information about all data sets that 
have been associated with problems. 


Problem Directory 


This VSAM data set is the central file for all problem-related 
information. It contains the information used for problem 
selection, problem reporting, and problem data set management. 


Dump Directory 


This VSAM data set contains information used to identify a record in 
the dump that corresponds to a reguest for an address in the dump. 
It also contains additional information generated during dump 
analysis, such as symbol table records and map records. Each IPCS 
user concurrently viewing dumps requires his own dump directory. 
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Storage Estimates 


IPCS runs in a 1.5M address space and has the following requirements for 
disk storage. 


SYS1.PARMLIB 3 to 9 80-byte records. 
(IPCSPRxx Member) | 


Data Set Directory Approximately 57 data set record groups per 
3330 format track, assuming 2 problen 
associations per data set. 


Problem Directory Approximately six problem record groups per 
3330 format track, assuming five associated 
data sets and 10 lines of description per 


problen. 

Dump Data Set 86 tracks of 3330 storage for each 1M 
bytes of dump data. 

Dump Directory 38 tracks of 3330 storage per dump 
(average). 
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Section 3. Supplemental Information 


This section contains information for the system planner about 
publications supvort and module identification for IPCS. 


Supporting Publications 


The publication that describes IPCS and its use is OS/VS2 MVS 
Interactive Problem Control System (IPCS) User's Guide and Reference, 
GC 34-2006. 


The publication OS/VS2 MVS Interactive Problem Control System (IPCS) 
Messages and Codes, GC34-2007, contains a listing of all messages and 
user completion codes issued by IPCS, along with explanations and 
associated problem determination actions. This information is provided 
in the format of the OS/VS messages library so that it can be filed with 
other messages documentation. 


A description of the functions performed by IPCS is contained in the 


For information needed to maintain or modify the IPCS program, refer to 
QOS/VS2 MVS Interactive Problem Control System (IPCS) Logic, SY25-0001. 


Supplements to the following publications also contain overview 
information about IPCS: 


Supplement to OS/Vs2 MVS System Pr mming Library: Service Aids 
(GC28-0674), GD23-0094. 


Supplement to OS/VS2 System Programming Library: Debugging Handbook 
(GC28-0708) , GD23-0096. 


Supplement to OS/VS2 System Programming Library: M 
Technigues (GC28-0725), GD23-0095. 


le 
Ilo 
be 
is 
fe) 
nn 
cr 
Ia 


Module Information 


All the modules supplied with IPCS are new and have module names 
beginning with BLS. Storage estimates for the IPCS component are 
contained in Section 2. 
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